Micron Document
πŸŽ–οΈGitΠ―Ρ€Π°πŸŽ–οΈ


Displaying Raw β€’ View rendered β€’ Download

docs/pl-rPL/user/widget.md bd2863243bab6eb213401d949839a2bc74dde7e2 (bd286324) Text, 1.88 KB

---
title: Home Screen Widget
parent: User Guide
nav_order: 20
last_updated: 2026-06-25
description: Add the Meshtastic home screen widget to glance at your connected radio's local stats without opening the app.
aliases:
Tff7b72- widget
Tff7b72- home-screen-widget
Tc9d1d9 - local-stats-widget
Tc9d1d9---

Tc9d1d9# Home Screen Widget

On Android, Meshtastic provides a home screen **widget** that shows live local statistics from your connected radio at a glance β€” no need to open the app.

Tc9d1d9## What It Shows

The widget displays the **connected radio's** current local stats:

Tff7b72- **Battery** β€” the radio's battery level, or _Powered_ when running on external power
Tff7b72- **ChUtil** β€” channel utilization (how busy the LoRa channel is, as a percentage)
Tff7b72- **AirUtil** β€” airtime utilization (how much of the duty cycle your radio is transmitting)
Tff7b72- **Traffic** β€” packets transmitted / received, and duplicates seen
Tff7b72- **Relays** β€” packets relayed and relay cancellations (shown when the radio is relaying)

Tap the widget to open the app, or use its refresh control to request fresh stats.

Tff7b72> πŸ’‘ **Tip:** The values reflect the radio you are currently connected to. If the app isn't connected to a radio, the widget shows the last known stats until it reconnects.

Tc9d1d9## Adding the Widget

Tff7b721. Long-press an empty area of your Android home screen.
Tff7b722. Tap **Widgets**.
Tff7b723. Find **Meshtastic** in the list and drag the **Local Stats** widget to your home screen.
Tff7b724. Resize it as needed β€” the layout adapts to the available space.

Tff7b72> ⚠️ **Note:** The widget is Android-only. It is not available on the Desktop or iOS builds.

Tc9d1d9## Related Topics

Tff7b72- [Tff7b72Node Metrics](Te6edf3node-metrics) β€” the full Signal Quality and Local Stats history inside the app
Tff7b72- [Tff7b72Connections](Te6edf3connections) β€” connect to a radio so the widget has stats to show
Tff7b72- [Tff7b72Discovery](Te6edf3discovery) β€” channel and airtime utilization across the mesh

---

Served by rngit 1.5.0 - Generated in 0.04s